<html>
<head>
<title>ZFS Message ID: ZFS-8000-14</title>
</head>
<body>
<!--
 CDDL HEADER START

 The contents of this file are subject to the terms of the
 Common Development and Distribution License (the "License").
 You may not use this file except in compliance with the License.

 You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
 or http://www.opensolaris.org/os/licensing.
 See the License for the specific language governing permissions
 and limitations under the License.

 When distributing Covered Code, include this CDDL HEADER in each
 file and include the License file at usr/src/OPENSOLARIS.LICENSE.
 If applicable, add the following below this CDDL HEADER, with the
 fields enclosed by brackets "[]" replaced with your own identifying
 information: Portions Copyright [yyyy] [name of copyright owner]

 CDDL HEADER END
-->
<!-- start: templates/success -->
<!-- ident      "@(#)success    1.4     02/14/14 SMI" -->
Article for Message ID:&nbsp;&nbsp; <font size="+1"><tt><b>ZFS-8000-14</b></tt></font>
<br><br>
<hr>
<br><br>
<!-- end: templates/success -->
<!-- start: article -->
<!-- code: ZFS-8000-14 -->
<!-- keys: ereport.fs.zfs.pool.corrupt_cache -->
<table width="80%"><tr><td>
<b>Corrupt ZFS cache</b>
<p>
<dl>
<dt><p><b>Type</b>
<dd>Error
<dt><p><b>Severity</b>
<dd>Critical
<dt><p><b>Description</b>
<dd>The ZFS cache file is corrupted
<dt><p><b>Automated Response</b>
<dd>No automated response will be taken.
<dt><p><b>Impact</b>
<dd>ZFS filesystems are not available.
<dt><p><b>Suggested Action for System Administrator</b>
<dd>
<p>ZFS keeps a list of active pools on the filesystem to avoid having to
scan all devices when the system is booted.  If this file is corrupted, then
normally active pools will not be automatically opened.  The pools can be
recovered using the 'zpool import' command:</p>

<pre># zpool import
  pool: test
    id: 12743384782310107047
 state: ONLINE
action: The pool can be imported using its name or numeric identifier.
config:

        test              ONLINE
          sda9            ONLINE
</pre>

<p>This will automatically scan <tt>/dev</tt> for any
devices part of a pool.  If devices have been made available in an alternate
location, use the '-d' option to 'zpool import' to search for devices in a
different directory.</p>

<p>Once you have determined which pools are available for import, you can
import the pool explicitly by specifying the name or numeric
identifier:</p>

<pre># zpool import test
</pre>

<p>Alternately, you can import all available pools by specifying the
'-a' option.  Once a pool has been imported, the ZFS cache will be repaired so
that the pool will appear normally in the future.</p>
<dt><p><b>Details</b>
<dd>The Message ID: <tt>ZFS-8000-14</tt> indicates a
	    corrupted ZFS cache file. Take the documented action to resolve the problem.
</dl>
</td></tr></table>
<!-- end: article -->
</body></html>

